Pull request type

• Code changes (bugfix, features)
• ReadMe, Docs and GitHub updates

Checklist

• Docs have been reviewed and added / updated
• Lint (black rocketpy/ tests/) has passed locally
• All tests (pytest tests -m slow --runslow) have passed locally
• CHANGELOG.md has been updated (if relevant)

Note: --runslow is currently failing.

Current behavior

An error occurs while trying building docs due to many reasons, including:

• New release of docutils not supported by m2r2;
• pyproject.toml requires conf.py changes;
• lxml separated its html_clean to another repo for security.

All those library changes happened around late april and beginning of may.

New behavior

The following changes were made:

• Limit docutils version to 0.20.1;
• Add to docs/requirements the new lxml_html_clean;
• Add PYTHONPATH to conf.py.

Following sphinx docs recommendation, in order to avoid breaking docs due to dependency updates pip-tools was used to pin down all docs dependencies.

The following procedure should be followed to add/update a docs dependency:

1. Add the new top-level dependency to docs/requirements.in;
2. Run pip-compile docs/requirements.in.

Breaking change

• Yes
• No

Additional information

The PR #584 removes README.md from the docs, allowing the removal of m2r2 dependency and the limitation of docutils version.